home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / uhren & terminkalender / time / dclock15 / dclock.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  9KB  |  188 lines
  1. @DATABASE DClock.guide
  2. @NODE Main "DClock - The guide"
  3.     DClock V1.5 - The ultimate, menu driven Workbench-Clock
  4.     =======================================================
  5.     Table of Contents
  6.     -----------------
  7.     @{" Introduction    " link Intro}  DClock - The introduction
  8.     @{" Installation    " link Installation}  DClock - The installation
  9.     @{" Menus           " link Menus}  DClock - The magic menus
  10.     @{" Legalities      " link Legals}  DClock - The legal stuff
  11.     @{" Author Info     " link Author}  DClock - The author
  12.     @{" History         " link History}  DClock - The story
  13.     @{" Commercial      " link Commercial}  DClock - The t-shirt
  14. @ENDNODE
  15. @NODE Intro "DClock - The Introduction"
  16.     Introduction
  17.     ------------
  18.     DClock is a digital clock program for the Amiga Workbench.
  19.     Features include:
  20.     - DClock has it's own small window which can be placed
  21.       anywhere on the Workbench screen.
  22.     - DClock  comes with a completely  menu-driven GUI. No
  23.       commandline options are necessary.
  24.     - Timer and alarm clock function with the ability to
  25.       run user-defined Shell commands (including ARexx-
  26.       scripts if you use the RX command, and Shell-scripts
  27.       with the Execute command).
  28.     - Date function
  29.     - Fore- and  background colors of the window are user-
  30.       defineable.
  31.     - All settings  can be saved and will automatically be
  32.       loaded upon startup. This  includes the  position of
  33.       the DClock window, the  colors, and  the settings of
  34.       the alarm clock.
  35. @ENDNODE
  36. @NODE Installation "DClock - The installation"
  37.     Requirements and Installation
  38.     -----------------------------
  39.     DClock makes use of the  reqtools.library, which is not part
  40.     of this distribution. It is  available  on Aminet or  on the
  41.     Amiga software library (fish) disks. Thanks to Nico Francois
  42.     for his great product.
  43.     You need Kickstart 2.04+ to be able to run DClock. If DClock
  44.     immediately  returns after startup, check  whether you  have
  45.            Kickstart V37+
  46.            reqtools.library V38+
  47.            a public screen called 'Workbench'
  48.            enough free memory
  49.     Installation is very simple: Simply drag  the DClock icon to
  50.     the WBStartup drawer of your system partition/disk or to any
  51.     other drawer, if you don't want DClock to be started automa-
  52.     tically after booting.
  53. @ENDNODE
  54. @NODE Menus "DClock - The magic menus"
  55.     DClock Menus
  56.     ------------
  57.     While the DClock window is active, you can select the follo-
  58.     wing menu items:
  59.     DClock menu:
  60.        Seconds (toggle) : Display seconds on/off
  61.        24H (toggle)     : Toggle between 24 hour mode or 12 hour
  62.                           AM/PM mode, and, if Date is on,
  63.                           between DD.MM.YYYY and MM.DD.YYYY
  64.        Date (toggle)    : Turn date on/off
  65.        Alarm on (toggle): Turn alarm function on/off
  66.        Timer on (toggle): Turn timer function on/off
  67.        Set alarm clock  : Set the alarm time
  68.        Set timer        : Set the timer
  69.        Alarm command    : Enter a Shell-command which will be
  70.                           executed when the alarm went off.
  71.                           RUN your command if if it takes longer
  72.                           and you don't want to block out the GUI.
  73.        Timer command    : dito for the timer.
  74.        Save Preferences : Save all the settings to
  75.                           ENVARC:DClock.prefs
  76.        About...         : Information about @{" The Author " link Author}
  77.        Quit             : Call the Terminator
  78.     Window menu:
  79.        Foreground Color : Set the foreground (text) color
  80.        Background Color : Set the background color (who would
  81.                           have guessed...)
  82.        Dragbar (toggle) : Turn the window dragbar and title on
  83.                           and off. The state of the checkmark
  84.                           will be saved in the preferences file.
  85.        Activate (toggle): Activate DClock window after startup/
  86.                           reopen.
  87.     When you select `Save Preferences'  from  the  Project menu, the
  88.     state  of the alarm  clock  will be saved, too. The  alarm  will
  89.     then be automatically turned on after startup (if it was on when
  90.     you saved  the prefs, off course). I e.g. set the  alarm to 1.00
  91.     AM, switched  it on and  selected `Save preferences'. I  now get
  92.     reminded every day that it's time to go to bed without having to
  93.     set the alarm again and again.
  94. @ENDNODE
  95. @NODE Legals "DClock - The legal stuff"
  96.     Legal section
  97.     -------------
  98.     This program is Freely Distributable, as  opposed to Public
  99.     Domain.  Permission  is given  to  freely  distribute  this
  100.     program  provided  no  fee  is charged, and  this  documen-
  101.     tation  file  is included with the program. All  rights re-
  102.     served.
  103.     (c) 1994 by Karl Lukas
  104. @ENDNODE
  105. @NODE Author "DClock - The author"
  106.     Info about the author
  107.     ---------------------
  108.     Send bug reports, compliments and such to
  109.        kalle@gis.geogr.unizh.ch
  110.     Send postcards, money and other gifts to
  111.        Karl Lukas
  112.        Konradstr. 51
  113.        CH-8005 Zuerich/Switzerland
  114.     These addresses are valid until Feb. 1995. Send  snail mail
  115.     to
  116.        Karl Lukas
  117.        Hinterzweienstr. 91
  118.        CH-4132 Muttenz
  119.     after  this date. I don't  know if I'll have an email
  120.     account by then :(   (God, how can one live without?)
  121.     Send threatening letters, letter bombs a.s.o. to
  122.        NIL:
  123. @ENDNODE
  124. @NODE History "DClock - The story"
  125.     History
  126.     -------
  127.     V1.0 Apr 1994 o Initial release
  128.     V1.1 Jun 1994 o DClock now runs three independent tasks:
  129.                     - User interface  (DClock)
  130.                     - Updating of the DClock window, timer etc.
  131.                       (DClockTask)
  132.                     - display information when alarm went off or
  133.                       timer is finished (DClockInfo).
  134.                     Advantage: Clock and timer won't be stopped tem-
  135.                     porarily while a window/requester is open. You
  136.                     can get informed now when the timer/alarm went
  137.                     off while a window/requester is open.
  138.                   o Bug: The alarm and timer symbols were drawn with
  139.                     incorrect offsets, so that the display got mes-
  140.                     sed if big screen fonts were used.
  141.                   o The settings are now stored in ENVARC:DClock.prefs
  142.                     You can copy your old DClock.prefs file from S: to
  143.                     ENVARC: if you want to use your old settings.
  144.     V1.2 Nov 1994 o You can now enter a Shell command, which will be
  145.                     executed when the alarm or the timer went off. The
  146.                     command can be saved to the preferences file. If you
  147.                     don't want to execute a command, just enter an empty
  148.                     string.
  149.                   o The current time is now displayed with two digits
  150.                     in the alarm/timer requester (i.e. 18:08:12 instead
  151.                     of 18:8:12). Hey, there is an ANSI function for
  152.                     this. Why didn't anybody tell me?  ;)
  153.                   o You can now turn the titlebar and dragbar off with
  154.                     the menu option "Dragbar". Off course you cannot move
  155.                     the window anymore when the dragbar is turned off.
  156.                     You can save the state of the "Dragbar" menu item to
  157.                     the preferences. THIS ONLY TAKES EFFECT WHEN YOU QUIT
  158.                     AND START DCLOCK AGAIN.
  159.     V1.3 Nov 1994 o OK, the dragbar switching was not very elegant. Now
  160.                     you can turn the dragbar on and off without leaving
  161.                     the program.
  162.                   o Got rid of the `Snapshot position' menu item. Now
  163.                     `Save preferences' saves the current position, too.
  164.                   o I rearranged the menus to a somewhat more logical
  165.                     order.
  166.                   o `Alarm command' and `Timer command' now use the
  167.                      SystemTagList() function. A console window is opened
  168.                      as stdin/stdout for the executed program, so you can
  169.                      actually _see_ it's output if you started DClock from
  170.                      the Workbench. Nice, isn't it?
  171.     V1.4 Dec 1994 o 12 hour AM/PM mode added.
  172.     V1.5 Dec 1994 o (I should actually be preparing for my exams... :)
  173.                   o Little bug fixed: You could deadlock DClock by
  174.                     immediately quitting it after startup (this was
  175.                     only theoretical as you had no chance to immediately
  176.                     quit DClock because the window was not activated).
  177.                   o OS3.0+ users now get white menus.
  178.                   o Date function added. If the 24H mode is active,
  179.                     the date is displayed as DD.MM.YYYY. Otherwise day and
  180.                     month are swapped (i.e. MM.DD.YYYY). I hope this suits
  181.                     your needs.
  182.                   o New menu item `Activate' added.
  183.                   o New menu shortcuts added
  184. @ENDNODE
  185. @NODE Commercial "DClock - The t-shirt"
  186.     Just kidding ;)
  187. @ENDNODE
  188.